Converts any lowercase characters in a text string into their uppercase equivalents.

void UppercaseText (
    Ptr textPtr, 
    SInt16 len, 
    ScriptCode script
);

Parameter descriptions

textPtr

A pointer to the text string to be converted.

len

The length, in bytes, of the text string. The text string can be up to 32 KB in length.

script

The script code of the script system whose case conversion rules are used for determining uppercase character equivalents.

The conversion uses tables in the string-manipulation ('itl2') resource of the specified script. You can specify smSystemScript to use the system script and smCurrentScript to use the script of the current font in the current graphics port.

DISCUSSION

UppercaseText traverses the characters starting at the address specified by textPtr and continues for the number of characters specified in len. It converts any lowercase characters in the text into uppercase.

If UppercaseText cannot access the specified resource, it generates an error code and does not modify the string. You need to call the ResError function to determine which, if any, error occurred.

SPECIAL CONSIDERATIONS

UppercaseText may move memory; your application should not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)